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A New Book Appears 


Jim Sather's new book, Understanding the Apple //e, arrived 
today. We'll have a complete review next month, but at first 
glance it looks even better than his first book. Check our ad 
on page 3 for pricing. 


And an Old Book Reappears 


Roger Wagner Publishing has obtained the rights to Roger's 
“Assembly Lines -- the Book" from Softalk. A new edition is 
now available, still at $19.95. We sold hundreds of copies of 
this book, which in excellent tutorial fashion leads a beginner 
into the fascinating world of assembly language. "Assembly 
Lines -- the Disk" is also available, with all the sample 
source code formatted for the Merlin assembler, If you wish to 
order the book from us, our price is only $18 plus shipping. 


Postage Increases 


The recent Post Office rate increases had little effect on the 
Bulk and First Class rates, only $.015-.03 per piece, or 
$.18-.36 per. year per subscription. We'll accept that much of 
a cost increase. Foreign Air Mail is another matter, though. 
Those rates went up by $.16-.19 per piece, or $1.92-2.28 per 
year per subscription. Therefore, the foreign subscription 
rate is now $32 per year. 


Putting S-C Macro on a QuikLoader Card..........Jan Eugenides 


The QuikLoader by Southern California Research Group is one of 
those rare devices that causes you to wonder how you ever got 
along without one. I have had mine for about a year now, and I 
would never go back to the old way of loading programs! 


Briefly, the QuikLoader allows you to put whatever programs you 
desire on EPROMS, which then plug into the QuikLoader. EPROMS 
from 2716-27512 can be used, for a possible 512K bytes of 
program space on one QuikLoader (equivalent to four Apple 
floppies!). You can have more than one card, of course, so 
there's lots of room available for just about anything. The 
QuikLoader also comes with DOS 3.3 already installed, along 
with FID, and COPYA. When you turn on your machine, you'll 
hear a little whoop instead of the familiar beep. DOS has just 
been loaded in about 2 seconds. No more booting! In fact, I 
seldom put DOS on a disk anymore, and I can use the space for 
programs instead. 


Programs which are on the QuikLoader can be loaded into RAM and 
executed in about 2 seconds, with just two keystrokes! Since 
they are loaded into their regular RAM locations, they do NOT 
need to be modified in any way. 


You can see a catalog of the QuikLoader by typing "Q" followed 
by RESET. The program names appear with letters A-Z next to 
them. Then you can select and run the programs by typing the 
letter corresponding to that program. Alternatively, if you 
want to run the primary routine on a chip, just press the 
number of the socket it is in followed by RESET. More on this 
later. 


Putting programs on the QuikLoader is somewhat problematical, 
however. The manual is STILL in it's draft form, although they 
have been promising a better one for over a year. Oh well...a 
little trial and error is good for the soul. 


In order to put the S-C Macro Assembler on the QuikLoader, it 
is necessary to write what's known as a “primary” routine. The 
QuikLoader has a built-in operating system which allows you to 
move blocks of memory to their RAM locations from the various 
EPROMS on the QuikLoader card, and then execute them however 
you wish. The following program is intended to be used on a 
27128 EPROM, which will hold the entire S-C Macro Assembler, 
with driver (I used the Ultraterm driver for this program) and 
the Fast Bload patches, which I chose to load between DOS and 
its buffers, rather than actually patch the DOS. You can do it 
either way, it's up to you. 


This program is called the “overhead” for the EPROM. It goes 
at S$FEBO in the actual chip. The catalog must appear at SFFOO. 
These are the addresses as the Apple would see them, not the 
absolute addresses relative to the chip. A 27128 will address 
as though it runs from $C000 to SFFFF as far as the Apple is 
concerned. In other words, the chip's address $0000 equals the 
Apple's address $C000. Things are further complicated by the 
fact that an Apple II+ cannot address the range from $C000 to 
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Ss-Cc Macro Assembler Version 26 View ces Cee WO NS 44S EWS Es wee awe ae SLOU 
Version 2.0 Upgrade Kit for 1.0/1-.1/1-2 ownerS....cccccccccccccscceveee a0 
Source Code for Version 1 1 (on two disk SideS) ....ccccccccccccesccee lI 
Full Screen Editor for S-C Macro (with complete source code) ......ec.eeS49 
S-C Cross Reference Utility (without source code) ......cccccccvccccccceS20 
S~-C Cross Reference Utility (with complete source code) ....ccccccceese $50 
DISASM Dis-Assembler (RAK“WALG) 668.605 0-60 5.0 6 665-06 00 Ni 605 46 046 bse ewe ee SOU 
Source Code for DISASM-cccccvcccscusersesnecesccvecsvcesececcs BOcitional $30 
S-C Word Processor (with complete Source COdE)-..ccccccccccccccscvesee D0 
DP18 Source and (0) 6 | 2) See ee ee eee eee ee ee eee yt 
Double Precision Floating Point for Applesoft (with source code)......$50 
S-C Documentor (complete commented source code of Applesoft ROMs).....$50 
Source Code of //e CX & F8 ROMS ON GiBk.ccccccccccccccscccccccsccccsccse SS 


(All source code is formatted for S-C Macro Assembler. Other assemblers 
require some effort to convert file type and edit directives.) 


AAL Quarterly DiSkS....ccccscccccccccccccesee@ach $15, or any four for $45 
Jan-Mar Apr-Jun Jul-Sep Oct-Dec 
1 


Each disk contains 1980 - - - 

the source code from 1981 2 3 4 5 

three issues of AAL, 1982 6 7 8 9 

saving you lots of 1983 10 11 12 13 

typing and testing. 1984 14 15 16 17 
1985 18 


AWIIe Toolkit (Don LancaSter. SynergeticS) -...ccccccccccccccccccceseee gr 
Visible Computer: 6502 (Software Masters) ...cccccccccsecee (Lege $50) $45 
ES-CAPE: Extended S-C Applesoft Program Editor (new price. was $60) $40 
“Bag of Tricks", Worth & Lechner, with diskette.......ecceee ($39.95) $36 


Blank Diskettes (Verbatim) ..ccccccccccccccccccccces package Of 20 for $32 
(Premium quality, single-sided, double density, with hub rings) 
Vinyl disk pages, 6"x8.5", hold two disks each ....ccccccccvceeelO for $6 
Diskette Mailing Protectors (hold 1 or 2 disks)............-40 cents each 
(Cardboard folders designed to fit 6°X9° Envelopes.) or $25 per 100 
Envelopes for Diskette Mailer6....ccccsccccccccccccceccscece 6 Cents each 


quikLoader EPROM System (SCRG) 2 ss.00066e sds v ewes eects wewe ese es ($179) $170 
PROmGRAMER (SCRG) eisusede de tus sue bssw ese esi divnseawseescee (9149.50) $140 
D MAnual Controller (SCRG) -ccccccccnccccccvcseccccccccccesccsee (990) $85 
Switch-a-Slot (SCRG) 0.56 6660 0 656066566 Gi0 wd HSCs eK es eee vewes (5190) $175 
Extend-a-Slot (SCRG) (si eGe bs RUNES SNe e dee Wee dees weene eee (950) $32 
Write Guard Disk Mod Kit (Mark LV) e600 edeehs eter seen e Seu ersaeeeeuers $45 


Books. Books, BOOKS....ccccccccccccccccsesess sCOMpare Our discount prices! 


"Inside the Apple J/0", Little Coe 0464S 08544 6S she eee wwe COLS. S95) $18 
"Inside the Apple //e", Little ..ccccccccccccccccccsccvcccesee (919.95) $18 
"Apple II+/IIe Troubleshooting & Repair Guide", Brenner-.....($19.95) $18 
"Apple J][ Circuit Description", Gayler ...ccccccccccccccccces (922.99) $21 
“Understanding the Apple II", Sather ccccccccccvcccccveccsvee ($220.99) $21 
"Understanding the Apple //fe", Sather Cee eve ewevewceneeweeoe ($24.95) $23 
"Enhancing Your Apple II, vol. 1", Lancaster ...ccccccceesee ($15.95) $15 
“Assembly Cookbook for the Apple II/IIe“, Lancaster.........($21.95) $20 
“Incredible Secret Money Machine", LancaSter ..cccccccccccces (9! 95) $7 
"Beneath Apple DOS", Worth & LeEChner...cccccccccccccccccccce ($19.95) $18 
“Beneath Apple ProDOS", Worth & Lechner ..ccccccccccccccccee ($19.95) $18 
“What's Where in the Apple®, Second Edition......ccccccccecee ($19.95) $19 
"6502 Assembly Language Programming", Leventhal.....ceseseee ($18.95) $18 
"6502 Subroutines", Leventhal... ..ccccccccccccccccccsccccccce (918.95) $18 
“Real Time Programming -- Neglected Topics", Foster.....sceee ($9.95) $9 
"Microcomputer Graphics", MYErS..ccccceccceccccccsccceseceee(GL2.99) $12 
“Assem, Language for Applesoft Programmers", Finley & Myers. ($16.95) $16 
“Assembly Lines =e the Book“, Wagner. ewe hee oeweeeatewee~cee (OLS s 95) $18 


Add $1 50 per book for US shipping. Foreign orders add postage needed. 


Texas residents please add 6 1/8 % sales tax to all orders. 


*%& S-C SOFTWARE- P. O- BOX 280300, Dallas, TX 75228 *** 
eee (214) 324-2050 wee 
*** We accept Master Card, VISA and American Express *** 
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SC7FF without a small circuit modification. In this case it's 
no problem, the space from $C800-SFFFF is more than enough to 
house the entire assembler. If you needed more space, you 
could put your primary routine in the $CO0O0-SC7FF space. 


The rest of the EPROM contains the code for the assembler 
itself, and the fast Bload patch. The assembler goes trom 
SC800-SEFFF, and the Bload patch from $F000 to SF0O4D. You must 
pack these files together in RAM somewhere prior to burning the 
chip. In other words, Bload the assembler at, say, $2800-4FFF. 
Put the Bload patch at $5000-504D Then Bload the overhead 
program at S$5EBO. The rest of the EPROM doesn't matter. Then 
burn all this stuff into the EPROM starting at $800 relative to 
the chip. Thus, when you install the chip on the card, it will 
show up at SC800-FFFF like it should. If your EPROM burner 
won't burn partial chips, just start the burn from $2000 and 
it'll work out. 


That's it. Just install the chip on the QuikLoader in any 
socket. To run the assembler just type the socket number 
followed by RESET. In two seconds the assembler will load and 
start! No more waiting to boot DOS, load the program, etc. 
You don't even have to look for a disk! Sure speeds up the 
work. 


This should help augment the information in the manual a 
little, and get you on your way. I have installed the S-C 
assembler, Rak-ware's DISASM, a modified SOURCEROR (it now 
ouputs S-C format code, heh heh), the S-C Word Processor, a 
terminal program of my own design (it's capture buffer exactly 
coincides with the S-C Word Processor buffer! I can come 
off-line and begin editing with two keystrokes, and no disk 
access!), and some other utilities. All stored inside the 
Apple, available instantly at any time. For $170 (the price 
from S-C Software), the QuikLoader is a MUST. 


By the way, for a reasonable fee I will install programs on 
EPROMS for you. You supply the programs and EPROMS, and I'll 
do the rest. Some programs are not suitable...particularly 
those which access the disk a lot. They would require 
extensive modification and that's best left to the original 
author. Also, copy-protected stuff cannot be loaded, because 
there's no way to ge at the files. Contact me if you're 
interested, at 11601 NW 18th St., Pembroke Pines, FL 33026. 


[ For $20, S-C Software will send registered owners of version 
2.0 a 27128 with the S-C Macro Assembler on it. This adds five 
lines to the QuikLoader menu, allowing you to choose the screen 
driver you wish. Only the $D000 (language card) version is 
provided. ] 


Here's the overhead program, with GETSLOT overhead taken from 
the QuikLoader manual. 
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®S-C MACRO ASSEMBER OVERHEAD - ULTRATERM VERSION 
& by Jan Eugenides 

# 3/9/85 


OOSC0000 


e 


8Y-register indexes of the chip 0 routines 


Ao 
080 
090 
100 
110 
120 
1 0 tGeawoe > > > Ge aD Pp G&S > Gn OS EF Sp SD Ge GP GF Os GS Ga > a > a> Gb ab GP 
180 ® 
ae 170 MOVEBLK -EQ 0 Move data block to RAM 
08- 180 GOMRBRD EQ 8 Go to motherboard 
179 fone nn nnn nnn nnn nnnnnn nnn nnnee nnn 
190 # GENERAL EQUATES 
200 @ 
OA) Srccucecesseweescoeneoeeosceeseus 
26 1220 PRISLOT -EQ $26 Storage for primary slot 
2D=- 1S30 QLMAP -EQ 32D bitmap of QL slots 
A- 1240 SRCL ~EQ indirect source 
20A— ioe SAVCTRL -EQ OA save control word 
C08 1— 1279 CTRL -EQ $C081 QL control register 
1280 # 
v0 : GET SLOT EQUATES 
12410. Oseseeeewceccsecesescenesceeeucke 
18—- 1320 QLOFF -EQ $18 00011000 QLOFF; CHIP 0 
20- 1 Be CHK -EQ $20 NUMBER OF FIND SLOT CHECKS 
k0- 1340 GSCL ~EQ $40 GET SLOT C PARAMETER. 
hie 1350 GSCH EQ $41 
42— 1360 GSEL -EQ $42 GET SLOT E PARM 
43 1370 GSEH »EQ $43 
C006— 1380 SLTXROM ~EQ $C006 IIE SOFT SWITCH 
COOA= 1330 INT3ROM -EQ $COOA e 
COOB- 1400 SLT3ROM -EQ $COOB a 
CFFF- aa CLRROM ~-EQ $CFFF 
ee -OR $FEBO 
i ‘ TF ASM.2.0.0H 
1420 * This program will start the assembler in 80x32 
ie # mode with ultraterm. Assumes that assembler has 
1480 ® been patched at $DBC9 and $DC11 for 32 line mode. 
1490 # i.e. the normal $17 is now $1F. If mode is changed 
1500 ® these bytes must be re-patched. ($2F for 48 line mode) 
1510 ® For S-C assember 2.0 March 1985 version with Bob's 
1eaG ; ultraterm driver attached at $F700. 
FEBO- AQ 00 12ho START.PROG LDA #0 Turn on Ultratern 
FEB2=- 20 00 C3 1320 JSR $C300 
FEB5= AQ 16 1560 LDA #22 bring up in 80x32 mode 
FEB7= 20 ED FD 1310 JSR DED 
PEBC- 20 ED FD 1290 JSR $FDED °°” 
FEBF= AQ CB 1860 LDA $CB 
te is a 03 toon rok a set warmstart vector 
FEC6- 8D 00 9D 1930 STA $9D00 make room between DOS a buffers 
FEC9= 20 DH AT 1 0 JSR $A7D4 for fast BLOAD patch 
FECC= AQ 30 1650 LDA #$30 
oe i. ac AC bas ace patch dos to call fast Bload 
FED3=- 8D AT AC 1970 STA Hae which is now at $9C30 
FEET 8p 06 EO 980 LM ao 
bret 
FEDB- AQ 00 1710 LDA #0 
PEDD- i oN EO 1730 STA A put assembler coldstart vector at $E000 
FEE2= 8D 02 EO 1740 STA 002 
FEE5- AD 80 CO 1750 LDA ic089 select ram card 
FEE8- 4C 00 DO 1760 JMP $D000 coldstart assembler 
1770 SP.END 
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BO: Wedeseeseee see eee eeeeceeeesesnus 
FEEB- ; . -BS $FFO0-# SKIP TO FFOO 
®KATALOG ENTRIES START HERE 
FFOO- 90 QO ASMK ~DA #$90 PRIMARY 
FFO1=- 9F FF eDA N.RESET SOURCE 
Ha 0 00 ~DA $0000 LENGTH 
FFO5- 00 00 


-DA $0000 DESTINATION 
FFOT- Ci D3 CD AS -"ASM* 


-DA #$86 END OF KAT RECORD 


0 

0 

0 

0 

0 

: 

O ASMPARM1 -DA $C800 SOURCE assembler + driver s here 
9 0-$F7FF 
0 

0 

0 

0 

0 


FFOB- 00 C8 
OD- 2 -DA $27FF LENGTH will load from $D00 
FFOF- 00 D -DA $D000 DESTINATION 
FF11- 00 FO ASMPARM2 -DA $F000 SOURCE fast bload routine 
FF13- 4D 00 ? DA $004&D LENGTH 
FF15=- 30 9C : eDA 39C30 
FF1I7= 4A INVERT LSR 
FF1IS—~ 6A 90 OR 
FF19= 6A 2000 ROR 
FF1A—- 6A 2010 ROR 
FF1IB- 29 E0 2020 AND 4 ae 
FF1D- 8D OA 02 2030 STA SAVCTRL 
FF20- 60 .. " 7 RTS 
FF21- 2060 BS fFFDo SKIP TO FF53 
FF53—- AQ 48 2070 OFFLP LDA #QLOFF 
FF55- 2b 1 CO 2080 STA QLCTRL ,X TURN OFF THE QL 
FF58=- 20 5D FF 2090 RTSLOC JSR GETSLOT THIS INSTRUCTION AT $FF58 (RTS) 
FF5B- DO F6 2100 BNE OFFLP 
9110 @sdweeeacadaonackanen aan ccecceaae 
2120 & 


2130 ® FIND SLOT NUMBER BY COMPARING CNXX TO ENXX FOR EACH SLOT 
2140 © START WITH SLOT d USR MUST BE RESET FOR SEARCH TO BE 
® EFFECTIVE IN II OR IIE. 


2160 
FF5D- 8D 06 CO 2170 GETSLOT STA SLTXROM ENABLE IIE I/0 SELECTS 


FF60- 8D OB CO 2180 STA SLT3ROM 

FF63- AQ 00 2190 LDA #0 

FF65—- 85 40 2200 STA GSCL 

FF67- 85 42 2210 STA GSEL 

FF69- AQ C1 2220 TRYAGEN LDA #$C1 START WITH SLOT 1 

FF6B- 85 41 2230 STA GSCH 

FF6D- Ae E1 22 LDA #$E1 

FF6F- 85 43 2250 STA GSEH DESTINATION = $ENOO 

FF71- AO 20 2260 LDY #CHENUM GET NUMBER OF CHECKS TO VERIFY 
FF73- B1 40 2270 LOOKLP LDA (GSCL).Y 

aa - D1 42 2280 CMP (GSEL),Y 

FF77- DO 19 2290 BNE NOTHERE BRANCH IF QL NOT IN THIS SLOT 
FF79- 88 2300 DEY 

FF7A=- DO ii 2310 BNE LOOKLP 

FF/C- A 2320 LDA GSCH 

FFTE- A 2330 TAY 

FF7F- OA 2340 ASL GET SLOTNUM TIMES $10 TO x 
FFSO- OA 2350 ASL 

FF81- OA 2360 ASL 

FF82- OA 2370 ASL 

FF83- AA 2380 TAX 

FF84- B9 86 FE 2390 LDA ers GET BIT MAP 

FF87- 05 2D 2400 ORA QLMAP 

FF89- 85 2D 2410 STA QLMAP SET BIT IN QLMAP 

FF8B- 8D OA CO 2420 STA INT3ROM LEAVE INT3ROM AS NORMAL RESET DOES 


FF8E- ap FF CF ays LDA CLRROM EXPANSION ROM OFF 
FFQ1- 60 2h Ss 

FF92=- E6 41 2490 NOTHERE INC GSCH 

FFQU- E6 43 2500 INC GSEH CHECK IN NEXT SLOT 
FF96- DO DB BNE LOOKLP BRANCH ALWAYS 


251 
geet SB oeiie cee ence nce ce eweeeeecocen 
e230 gEQU $CO SHOULDN'T OCCUR; BOMB IF DOES 
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FF98— 80 2550 MAP -DA #$80 
FF99- 40 2560 -DA #$40 
FF9A- 20 2570 DA #$20 
FF9B- 10 2580 ~DA #310 
FF9C- 08 2290 DA #$08 
FF9D- O04 2600 ~DA #304 
FF9E- 02 ah ; DA #302 
26 30 0 : THIS IS N.RESET ROUTINE OF THIS CHIP 

FFOF- 20 17 FF see0 NORESET JSR INVERT Invert the control word 
FFA2= AO 05 2660 LDY 
FFA4= BS OB FF 2 Ao 1 LDA ASMPARM1-Y Move ASSEMBLER parms 
FFAT- 3 3A 00 2680 STA SRCL Y 
FFAA- 2690 DEY 
FFAB- 10 F 2700 BPL .1 
FFAD- AD 08 02 2710 LDA SAVCTR get control word 
FFBO=- A 2720 LDX PRISLOT slot in X reg 
FFB2- AO 00 2730 LDY VEB Command index for move block routine 
FFBY= 20 EC FF 2740 JSR GOCHIPO Call chip 0 to move block 
FFB7—- AO 05 2750 LDY 
ERB - 4} FF 2760 .2 LDA ASMPARM2.Y Move Fast Bload routine parms 

BC- 2170 STA rv 
FFBF- 0 DEY 
FFCO=- 10 F7 2790 BPL . 
FFC2= AD OA 02 2800 LDA SAVCTR et control word 
FFC5= A6 26 2810 LDX PRISLOT lot in X reg 
FFC7T~ AO 00 2820 LDY #MOVEBLK Command index - move block 
FFC9= 20 EC FF 2830 JSR GOCHIPO Call chip 0 
FFCC- AO 38 2840 LDY #SP.END-ST ART. PROG 
FFCE- B9 BO FE 2850 .3 LDA START.PROG,Y Move startup program to $300 
FFD1- 3g 00 03 2860 STA $300,Y 
FFD4- 2b T° DEY 
FFD5= 10 F 2 BPL 3 
FFD7- AQ 0 2890 LDA #302 put address-1 on stack 
FFD9=- 4 2900 PHA 
FFDA- i2 FF 2910 LDA #$FF 
FFDC- 2920 PHA 
FFDD- AO 08 2930 LDY #GOMRBRD jmp to $300 to start 
FFDF- AD OA 02 2940 LDA SAVCTRL 
FFE2= A6 26 2950 LDX PRISLOT 
FFE4- NC EC FF 33 : JMP GOCHIPO 
FFET—- 29 S $FFEC-# SKIP TO FFEC 
FFEC- 9D 81 CO 29 GOCHIPO STA QLCTRL,X GO TO CHIP 0 
FFEF- 4C OF FF 30 JMP N.RESEf DO N-RESET ROUTINE OF THIS CHIP 
FFF2- 3010 -BS 
FFF5—- 60 3020 RTS 
FFF6- 030 -BS 2 
FFF8—- 00 FF 040 ~DA ASMK FIRST KATALOG LOCATION 
FFFA- FB 03 050 -DA $3FB NMI VECTOR 

New Book: Inside the Apple //c 


What Gary Little did for the //e he has repeated for the //c. 
Of course a lot of the material is the same for both computers 
and both books, but there is much new material. If you have a 
//c and not a //e. then this book will be much more helpful. 


For 
the 


one thing, when explaining assembly language he includes 
new opcodes and address modes of the 65C02. For another, 
the chapter on Disk Operating Systems is now 100% ProDOS, and 
includes more detail on ProDOS than the //e book. Naturally, 
since the //c has no cassette port or I/O slots, that material 
has been left out- On the other hand there is a lot of new 
data about the Apple mouse port and the built-in serial ports. 


The book is published by Brady (Prentice-Hall), is 363 + xv 
pages, and sells for $19.95. (We'll send you one for a little 


less, see page 3 of this newsletter ) 
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The Number One, 
Best Selling, Expandable Ram Card for the Apple Is 


RAMWORKS“ 


7 


A Feu’ Reasons Why! 


It's Appleworks’ Best Friend 


A 64K RAMWORKS will add 46K to your available desktop 
mempry, a 128K RAMWORKS will add 91K, a 256K 
RAMWORKS will add 182K, and 512K RAMWORKS will add 
364K and a 1 meg RAMWORKS will give you nearly an 
800K DESKTOP. But RAMWORKS does more than just 
increase the desktop memory (as if that weren't enough). 
With RAMWORKS, Appleworks will be able to run up to 20 
times faster. And now only RAMWORKS does this all auto- 
matically with no need for any optional software. Apple- 
works is a very large program. So large, in fact, that it won't 
all fit in a 128K Apple, so Appleworks has to constandy go 
back to the disk drive for more data When you have a 
RAMWORKS card, you can have enough memory so that 
the entire Appleworks program can be loaded into the 
computer. This greatly increases the speed at which Apple- 
works operates because the disk drive operates at 300 
RPM. RAMWORKS operates at the speed of light! 


It's Compatible 

The simple fact is that RAMWORKS is compatible with 
more off-the-shelf software than any other RAM card. 
RAMWORKS is 100% compatible with ALL software written 
for the Apple 80 column and extended 80 column card. 
Additionally, RAMWORKS can emulate other RAM cards so 
software written for other cards will run without modifi- 
cation. Software written for RAMWORKS will not work on 
other cards. We can emulate others, but others can't 
emulate us. 


It's Easy 

RAMWORKS just plugs in and clear instructions show how 
to plug more memory chips into RAMWORKS as your 
needs increase. 


Its Popular 

Popularity translates into great software support because 
software companies can't support all RAM cards, they can 
only support the ones their customers are likely to own. 


It's Reasonable 

Applied Engineering's years of experience and wide 
product line really pays off, and because of our high 

sales levels we buy most of our LC. chips factory direct. So 
don't let our low prices fool you, they're caused by high 
volume production. That's why we can offer the most 
memory for the least money. 


It’s In Color 

For only $129 an RGB option can be added to RAMWORKS 
tO give you double high resolution color graphics and 
sharp 80 column text on any Apple compatible RGB 
monitor. The RGB option does not take up another slot, 
but rather it plugs into RAMWORKS. You can order the 
RGB option with your RAMWORKS or add it on at a 

later date. 


It Corrects Mistakes 

Let's say you bought some other RAM card (and that's a 
mistake) and your RAM card is not being recognized by 
Appleworks, Advanced VisiCalc, FlashCalc or other 
programs and you want RAMWORKS. No problem. The 
memory chips on the card that you have now, which is 
where most of the money is, can be unplugged and then 
plugged into the expansion sockets on RAMWORKS. 


It's Got It All 


& 80 Column Text 

& Double high resolution graphics 
(with of without RGB option) 

@ User Expandable to 1 Megabyte 

@ Can Use 64K or 256K RAMS in any combination 

@ Adds Memory to Appleworks 

& Accelerates Appleworks 

& 100% Compatible with All He software 

@ RAM Disk software available, compatible with 
PRO-DOS, DOS 3.3, and PASCAL ($29.00) 

EY RAM Disk available for CP’ M ($29.00) 

@ Visicakc preboot available ($29.00) 

& RGB option 

& Takes only one slot 

@ 3 year no hassle warranty 


Ramworks”™ with 64K Installed . . $179 
Ramworks” with 128K Installed |. . $249 
Ramworks” with 250K Installed $399 
Ramworks” with 512K Installed . $049 
Ramworks” with | MEG Installed......00002 i. $1199 
RGB Option (can be added later). . $129 
Call (214) 492-2027 


9am. tc 1) p.m. 7 days a week or 

Send check or money order to: 

P.O. Box 798 

Carrollton, Texas 75006 

MasterCard, Visu and C.O.D. welcome. 

No extra charge for credit cards. 

Texas residents add 5'«% sales tax. Add $10.00 if outside USA 


When you want to expand your He's memory and make Appleworks and other programs have more memory and go faster. 
why not do what Apple computer does, call Applied Engineering and ask for RAMWORKS. 


APPLIED ENGINEERING 
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Volume Catalog for Corvus and Sider........Bob Sander-Cederlof 


When I have a stack of floppies, I can quickly shuffle through 
them reading labels to find the two or three most likely to 
have the elusive file I want. On a hard disk it is hard to 
read the labels.... 


The last time I had a Corvus sitting in this room, there was a 
program on the utility disk which would list the first file 
name from each volume. If you were careful about making the 
first file name descriptive, it could act like a label. Of 
course, nearly every floppy around here has a first file named 
HELLO. Not too helpful. 


Several years ago Bill Morgan wrote a program we published in 
AAL called the Catalog Arranger. It allows you to re-arrange 
the filenames in any catalog to any order you wish, and to 
rename the files using any combination of upper/lower case, 
inverse, flashing, and control-characters. I use Catalog 
Arranger to make a “title” file at the beginning of each hard 
disk volume. (If you never heard of Catalog Arranger, you can 
type it in from AALs of October 1982 and January 1983. It is 
also available on a Quarterly disk for only $15.) 


Now that I don't have the Corvus, or its handy program for 
listing the names of the first file in each volume, I decided 
to write my own. The program that follows prints out the 
volume number, two spaces, and then the name of the first file. 
If the volume is empty, it prints “°<<<EMPTY VOLUME>>>". You 
can abort the listing by pressing RETURN or ESCAPE, or pause it 
by pressing any other key. 


Lines 1090-1100 set the origin at $803 and cause the object 
program to be written on a BRUNnable file called CAT. We write 
it at $803 rather than $800 so that Applesoft will work 
correctly after CAT is finished. Applesoft gets upset if $800 
has any non-zero value in it. 


I used two monitor routines. S$FD8E prints a carriage return, 
and $FDED prints any character from the A-register. 


I also used routines inside DOS. SAFF7 reads the VTOC of the 
current volume, using the inverse volume number from the 
variable R.VOLUME. If there is any error in trying to read the 
VTOC, DOS would normally go through its procedure of printing 
the message and returning to Applesoft. We cannot allow that, 
s0 I install a temporary patch to make the error condition 
cause a return to my code with carry set. If there is no 
error, Carry will be clear. The only likely error is that I am 
asking for the VTOC of a non-existing volume, which means I 
have already processed them all. The patching, call, and 
de-patching take place in lines 1160-1220. Line 1230 branches 
to my exit routine if there was an error reported. 


I also call on $B01l to read the first sector of the catalog. 
If you call $B0l11 with carry clear it reads the first sector of 
the catalog; with carry set, it reads the next sector of the 
catalog. The sector is read into a standard buffer at 


Apple Assembly Line.....April, 1985.....Copyright (C) S-C SOFTWARE.....Page 9 


SB4BB-B5BA. See “Beneath Apple DOS" for a complete 
description of the catalog sectors. 


Lines 1270-1440 convert the volume number to decimal and print 
it out, Lines 1450-1480 check for an empty directory. If it 
is empty, lines 1740-1800 print the empty volume message. 
Otherwise, lines 1490-1550 print the file name. Right here my 
program could use some improvement. It is possible for an 
empty volume to not look empty, because deleted files are not 
physically removed from the catalog. The byte we check for an 
empty volume could have $FF in it, signifying a deleted file. 
In this case my program should continue searching through the 
catalog for either the end or a non-deleted file. I didn't 
think it was absolutely necessary, since I was using Catalog 
Arranger to remove all deleted files from the catalog and 
position the title line at the very top. 


Line 1730 returns back to DOS by JMP $3D0. This reminds me of 
glitch we all run into from time to time. If you intend to 
BRUN a program from the command level of the assembler or of 
Applesoft, it needs to end with JMP $3D0. Ending with an RTS 
will not do, because BRUN does not leave any return address on 
the stack. On the other hand, if you intend to start the 
program by using a CALL or MGO or §$...G command, it is all 
right to end with an RTS. In fact, with a CALL from inside a 
running Applesoft program you MUST use an RTS. Just something 
to watch out for, 


1000 ®SAVE S.HARD CAT 
03D9- 1020 RWTS -EQ $03D9 
03E3- 1030 GETIOB -EQ $03E3 
BABB- 1050 CATALOG.BUFFER .EQ $B4BB 
B5F9- 1070 R.VOLUME .EQ $B5F9 
1090 .OR $803 
1100 ; AT 
1110 SBeaeanenewewnmmwewmowewwoowowewoe 
1120 HARD.CAT 
080 - 20 8E FD 1130 JSR $FD8E 
0806- AQ F 1140 LDA #$FE FOR VOLUME=1 TO 254 
0808— 8D F9 BS 1190 STA R.VO (.EOR.FF OF VOLUME #) 
1160 #--=PATCH DOS TO TRAP ERROR------ 
Op OR AB SE Bo 1160 ° STA {509 ee 
0810- 20 F7 AF 1190 : pense SAPET READ VTOC OF VOLUME 
a8 18 8B OE BO 1220 Lh tee 
0818- BO 5 1230 7 QUT OF LOOP, BEYOD LAST VOLUME 
1240 #---READ 1ST CATALOG SECTOR------ 
O81A- 18 1290 CLC 
eeteeret UES Aer Gpeine Voce @ 
081E- AD F9 BS5 1260 LDA R-VOLUME INVERSE OF # 
0821- 49 FF 1290 EOR #$FF BACK TO NORMAL FORM 
0823- A2 BO 1300 LDX #*0" CONVERT TO DECIMAL 
0825- C9 OA 1310 .2 CMP #10 ANY 10'S? 
0829- £9 OA 1 39 SBC #10 .«» YES, DIMINISH 
082B- E 1340 INX AND COUNT IT 
O82E- 48 1360 .3 PHA SAVE UNITS 
O82F- 8A 1 19 TXA PRINT TENS 
0830- 20 ED FD 1380 JSR $FDED 
0833- 68 1390 PLA GET UNITS 
0834- 09 BO 1400 ORA #"0" AND PRINT IT 
0836- 20 ED FD 1410 JSR $FDED 
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a ea | ne 
OBE. 30 ED ED q4u0 JSR $roED 

50 #-—-PRINT NAME OF FIRST FILE--——- 
0841- AO OB 0 
0843- BO BB BM 1470 LDA $B4BB, Y 
O84 FO 32 0 BEQ 8 .. EMPTY VOLUME 
OB4A- BO BE Bl 80 4 LDA {34BB+3,Y 
SHE gg lass oom 
ee Gee a 

ao #.--PRINT CARRIAGE RETURN-------- 
0856-20 8E FD 1570 ,5 JSR $FDBE 
0859- CE F9 B5 1590 DEC R. 


VOLUME 
#---POSSIBLE PAUSE OR ABORT------ 


00 
085C- AD 00 CO 1610 LDA $CO00 | ANY KEY PAUSES 
20 BPL . NO KEY 
0861- 8D 10 CO 30 STA $C010 
0864- C9 8D 0 CMP #$8D <RETURN> ABORTS 
O86 - FO 0c 50 BEQ , 
0868- AD 00 CO 1660 .6 LDA $CO0O PAUSE LOOP 
O86B- 10 70 BPL . 
O86D- 8D 10 CO 1680 STA }Co10 
0870- C9 8D 90 CMP #$8D AGAIN. RETURN AGORTS 
0872- DO 97 BO BNE . 
0874- 20 8E 20 .7 JSR $FD8E <RETURN> 
0877- HC DO 03 1730 JMP $300 BACK TO DOS 
0 #..-—MPTY V UME=-—= mn emen an tina oma oo an 
O87A- A2 00 50 . LDX #0 
087C- BD 87 08 1760 .9 LDA MT.X PRINT STRING BELOW 
OTF FO D5 70 5 
0881- 20 ED FD 1780 JSR $FDED 
0884- E8 90 
0885 DO F5 00 BNE .9 .» ALWAYS 
0887- BC BC BC 
O88A- C5 CD DO 
O88D- DA D9 AO 
0890- D6 CF CC 
0893 D5 CD C5 
0896- BE BE BE 1820 MT .AS -/<<<EMPTY VOLUME>>>/ 
0899+ 00 1830 “HS 00 


Don Lancaster's AWile TOOLKIT 


Solve all of your Applewriter™ Ile hassles with these eight diskette sides 
crammed full of most-needed goodies including .. . 


Patches for NULL, shortline, Ile detrashing, full expansion 
Invisible and automatic microjustify and proportional space 
Complete, thorough, and fully commented disassembly script 
Detailed source code capturing instructions for custom mods 
Clear and useful answers to hundreds of most-asked questions 
Camera ready print quality secrets (like this ad, ferinstance) 
New and mind-blowing WPL routines you simply won't believe 
Self-Prompting (!) glossaries for Diablo, Epson, many others 
Includes a free "must have" bonus book and helpline service 


All this and bunches more for only $39.95. Everything is unlocked and 
unprotected. Order from SYNERGETICS, 746 First Street, Box 809-AAL, 
Thatcher, AZ, 85552. (602) 428-4073. VISA or MC accepted. 
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Shrinking Code Inside ProDOS..............-Bob Sander-Cederlof 


David Johnson challenged me a few days ago. We were talking 
about ProDOS: the need for a ProDOS version of the S-C Macro 
Assembler, the merits vs. enhanced DOS 3.3, and the rash of 

recent articles on shrinking various routines inside DOS to 

Make room for more features. 


I've been avoiding ProDOS as much as possible, trying not to 
notice its ever-increasing market-share. Dave's comment, 
“ProDOS is a fertile field for your shrinking talent,“ may have 
finally pushed me into action, 


I am trying to make the ProDOS version of the S-C Macro 
Assembler, but is hard. I have Apple's manuals, Beneath Apple 
ProDOS, and the supplement to the latter book which explains 
almost every line of ProDOS code. Nevertheless, version 1.1.1 
of ProDOS doesn't seem to conform to all these descriptions in 
every particular. I spent four hours last night chasing one 
little discrepancy. (Turned out to be my own bug, though.) 


In the process, I ran across the subroutine ProDOS uses to 
convert binary numbers to decimal for printing. In version 
1.1.1 it starts at S$A62F, and with comments looks like this. 


ieee SoAVE S.PRODOS NUMOUT 
1020 ~OR $A62F 
Apes -TA $800 
WONG: @eedesecce ae ocoesenccecescecascea 
1050 ® CONVERT 00.XX.AA FROM BINARY TO DECIMAL 
1060 * STORE UNITS DIGIT AT $201,Y 
7 : STORE OTHER DIGITS AT SUCCESSIVE LOWER ADDRESSES 
1090 # Note: it is assumed and required that 
1100 ®# ACCUM+2 already by zeroed! 
1110 # Either that, or already set to the 
ee : highest byte of a 24-bit value. 
i180 CONVERT. TO -DECIMAL 

A62F- 8E BO BC eh STX ACCUM+1 

A032 8D AF BC 1160 STA ACCUM 

A635= 20 4D A ve s1 JSR DIVIDE. ACCUM.BY. TEN 

A638- AD B2 BC 1180 LDA REMAINDER 

A63B- 09 BO 1190 ORA #*0* 

A63D- 3g 01 02 1200 STA BUFFER+1,Y 

A640- 1210 DEY 

A641— AD BC 1220 LDA ACCUM CHECK IF QUOTIENT ZERO 

A644—- OD BO BC 1230 ORA ACCUM+1 

A647— OD B1 BC 1240 ORA ACCUM+2 

64A- DO EO 1250 BNE .1 

A64C- 60 1260 RTS 
1270 stewenn nnn nn ne meen w ome w wwe we w en we 
1280 DIVIDE. ACCUM.BY.TEN 

A64D=- A2 18 1290 LDX #24 24 BITS IN DIVIDEND 

A64F- AQ 00 1300 LDA #0 START WITH REM=0 

A651=- 8D B2 BC 1310 STA REMAINDER 

A654- 20 D7 AA 1320 .1 JSR SHIFT. ACCUM.LEFT 

A657—- 2E B2 BC 1330 ROL REMAINDER 

A65A- 38 1340 SEC REDUCE REMAINDER MOD 10 

A65B- AD B2 BC 1350 LDA REMAINDER 

AO5SE- EQ OA 1360 SBC #10 

A660- 2 06 1370 BCC .2 STILL < 10 

A662= 8D B2 BC 1380 STA REMAINDER 

A6- EE AF BC 1390 INC ACCUM QUOTIENT BIT 

AG6 - CA 1400 .2 DEX NEXT BIT 

Ao69=- DO EI 1410 BNE . 

A66B- 60 1420 RTS 
1430 @-eenn ee eee enw ewe ee 
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1440 ACCUM ~EQ BCAF »BCBO,BCB1 
BCB2- 1450 REMAINDER .EQ 
0200- 1460 B BUFFER .EQ 5360 
Vf i OR $AAD7 
1490 TA $900 
1500 Seannncnnn wenn nmewewswewewoeweenn 
49 SHIFT . ACCUM. LEFT 
AAD] - OE BC ASL ACCUM 
AADA- 2E BO BC 1 3 ROL ACCUM+1 
AADD- 2E B1 BC 1 ROL ACCUM+2 
AAEO- 60 1550 


The conversion routine is designed to handle values between 0 
and SFFFFFF. The highest byte must already have been stored at 
ACCUM+2 before calling CONVERT.TO.DECIMAL. The middle byte 
must be in the X-register, and the low byte in the A-register. 
The decimal digits will be stored in ASCII in the $200 buffer, 
starting and $201+Y and working backwards. 


One way of converting from binary to decimal is to perform a 
series of divide-by-ten operations. After each division, the 
remainder will be the next digit of the decimal value, working 
from right to left. That is the technique ProDOS uses, and the 
division is done by the subroutine in lines 1280-1420. 


The dividend is in ACCUM, a 3~-byte variable. The low byte is 
first, then the middle, and finally the high byte. One more 
byte is set aside for the remainder. A 24-step loop is set up 
to process all 24 bits of ACCUM. In the loop ACCUM and 
REMAINDER are shifted left. If REMAINDER is 10 or more, it is 
reduced by ten and the next quotient bit set to 1; otherwise 
the next quotient bit is 0. 


The first possible improvement I noted was in the area of lines 
1330-1360. the ROL REMAINDER will always leave carry status 
Clear, because we never let REMAINDER get larger than 9. If we 
delete the SEC instruction, and change SBC #10 to SBC #9 
(because carry clear means we need to borrow), we can save one 
byte. But that’s not really worth the effort. 


Next I realized that REMAINDER could be carried in the 
A-register within the 24-step loop, and not stored until the 
end of the loop. Here is that version, which saves seven bytes 
(original = 31 bytes, this one = 24 bytes): 


260 DIVIDE. ACCUM.BY. TEN 
LDX 


1 
O81E- A2 18 Mean #24 24 BITS IN DIVIDEND 
0820- AQ 00 1280 LDA #0 START WITH REM=0 
0 a8 20 3A 08 aa 1 JSR SHIFT, ACCUM. LEFT 
0838- C9 OA 1310 CMP #10 
0828- 90 05 1320 BCC .2 STILL < 10 
O82A- Be of 1 Be SBC #10 
082C- 36 08 1340 INC ACCUM QUOTIENT BIT 
O82F- CA 1 28 02 DEX NEXT BIT 
0830- RO FO 1360 BNE .1 
0832- 8D 39 08 1 1° STA REMAINDER 
0835- 60 1380 RTS 


To make sure my version really worked, I re-assembled the 
conversion program with an origin of $800, and appended a 
little test program. Here is my test program, which converts 
the value at $0000...0002 and prints it out. 
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O844—- AS 09 1510 T LDA 0 

0846- 8D 3 08 1520 STA ACCUM+2 

0849 AG 1530 LDX 1 

BeNDe Ao Os 1350 LDY #10 

ORK 20 00 08 1380 JSR CONVERT. TO.DECIMAL 
0 5 a BO 01 02 1560 ° LDA BUFFER+1,Y 

0859- CO OA 1260 CPY #10 

085B- 90 F5 1610 BCC , 

085D- 60 1620 


My best version is yet to come. I considered the fact that we 
could SHIFT the next quotient bit into the low end of ACCUM 
rather than using INC ACCUM to set a one-bit. I rearranged the 
loop so that the remainder reduction was done first, followed 
by the shift-left operation. I had to change the remainder 
reduction to work modulo 5 rather than 10, because the shifting 
operation came afterwards. I also had to include my own three 
lines of code to ROL ACCUM. since the little subroutine in 
ProDOS started with ASL ACCUM. The result is still shorter 
than 31 bytes, but only four bytes shorter. Nevertheless, it 
is faster and neater, in my opinion. 


1640 DIVIDE. ACCUM. BY. TEN,SHORTEST 
1650 LDX #24 24 BITS IN DIVIDEND 
0860- AQ 00 1660 LDA #0 START WITH REM=0 
0862=- C9 05 1670 1 CMP #5 

0 BCC .2 STILL < 10 


0868- EQ 0 1690 SBC #5 

OS68—- 2E 3 1700 .2 ROL AC 

O86B- 2E I 08 1710 ROL ACCUM+1 

O86E- 2E 1720 ROL ACCUM+2 

O871=- 2A 1 Re ROL 

O872- CA 1740 DEX NEXT BIT 
0873- DO ED 1 rt BNE .1 

oe - 6D 39 08 1760 STA REMAINDER 

0875- 60 1770 RTS 


BLANKENSHIP BASIC 1000 REM sample listin 
the Apple II+, IIe, and IIe (3.3 BOS) 1010 SaueTiEe : 


Full Interpreter, not a pre-processor 1020 PERFORM "INPUT DATA" 
WHILE-ENDWHILE and REPEAT-UNTIL loops 1030 REPEAT 

True IF-THEN-ELSE-ENDIF, (Using WHEN) 1040 PERFORM "DATA CHECK" 
PRINT.USING, FILE, MERGE, RANDOMIZE 1050 WHEN A > 100 THEN 
PRINT and TAB commands work in HIRES 1060 PRINT "BIG NUMBER" 
80 columns supported on Ile and IIc 1070 ELSE 

Full Editor with AUTO-NUM and RENUM 1080 PRINT "SMALL NUMBER” 
Listings are indented automatically 1090 A=A+1 

Fast SORT, SEARCH and INSTR$ commands 1100 ENDWHEN 

- BOX, BOXFILL, DRAW.USING, and SOUND 1110 UNTIL A > 200 

- No more CHR$(4) for DOS commands 1120 END 

- DEFINE and PERFORM named procedures 1130 DEFINE “INPUT DATA" 


onmnrNoahLh wh = 


- 99% upward compatible with Applesoft 1140 REM this is a duany 


- Best Value Anywhere -- Guaranteed! 1150 REM 
1160 FINISH 


1170 DEFINE "DATA CHECK" 
1180 REM so is this 
1190 FINISH 


Money back if not entirely satisfied! 


procedure 


mail check to: 

John Blankenship $25 
P.O. Box 47934 

Atlanta GA 30362 postpaid 


Page 14.....Apple Assembly Line.....April, 1985.....Copyright (C) S-C SOFTWARE 


The Apple IIc 
with Z-RAM 


a 
PELEE ELE EEDA 
/ ‘ee 


Applied Engineering and Apple computer have 
teamed up to take your IIc to new heights. 


Applied Engineering's Z-RAM card for the IIc is 
available with 256K or 512K of additional memory 
and a powerful Z-80 microprocessor for running 
CP/M software. 


Z-RAM fits neatly inside the IIc. Installation is easy, 
clear instructions show you how. You'll need a 
screwdriver and about 10 minutes (if you can change 
a light bulb vou can install Z-RAM). 


Z-RAM and Appleworks will knock your socks off. 


A 256K Z-RAM will give you a 229K available desk- 
top and Appleworks will be completely loaded into 
memory. Appleworks will now run about 10 times 
faster in your IIc with 1 disk drive than in other IIc’s 
with two disk drives. A 512K Z-RAM will give you a 
413K available desktop. A 256K Z-RAM can be up- 
graded to 512K at a later date when your needs grow. 

Z-RAM is also a high speed solid state disk drive. 
With Z-RAM your programs will load and save over 
20 times faster. Z-RAM’s RAM disk is compatible with 
Applesoft, Pro-DOS, DOS 3.3, PASCAL and CP/M. And 
with Z-RAM you can copy a disk in one pass. Just 
insert the original, remove the original, insert blank 
disk! That's it! Z-RAM is another disk drive, only 20 
times faster, 4 times larger capacity, and no whirring, 
clicking or waiting! 


But before you start panting over all that extra 


memory, don't forget that the Z-RAM card has a built- 


in high speed Z-80 processor chip that allows you to 
run CP/M programs like Wordstar, dBASE I], Turbo 
PASCAL, Microsoft BASIC, FORTRAN and COBOL and 
over 3,000 other CP/M programs. So Z-RAM not only 
makes Apple programs run better and faster, it lets 
you run MORE programs. 


With the Z-RAM card installed, your Ic is still your 
IIc only now you'll have that extra memory that 
Appleworks and other programs need. And you can 
run all that great CP/M software that others can only 
dream about. 

Z-RAM is 100% compatible with all IIc software 
and hardware including the mouse, 2nd disk, 
modem and printer. Z-RAM is easily handled by the 
IIc power supply as power consumption is kept very 
low by using two custom integrated circuits and a 
patent pending power saving design. And Z-RAM is 
from Applied Engineering, the acknowledged leader 
and innovator of accessories for the Apple. 


Z-RAM comes complete with manual, RAM disk 
software, Z-80 operating system, CP/M manual and a 
3 year no hassle warranwy. 


So the next time somebody asks vou why you 
didn't get an IBM PC. tell him you bought a IIc 
because the IBM didn't have enough memory and 
was too slow and couldn't run CP/M software. And 
tell him vou made it past the 8th grade. 


$449 
$649 


Z-RAM with 256K 
Z-RAM with 512K 


Call (214) 492-2027 

9am. to 11 p.m. 7 davs a week 
Send check or money order to: 
Applied Engineering 

P. O. Box 798 

Carrollton, Texas 75006 


fa] 
MasterCard, ggg §=Visa and 
C.O.D. welcome. No extra charge for credit cards. 
Texas residents add 5'8% sales tax. Add $10.00 if 
outside U.S.A. 


FE 


APPLIED ENGINEERING 
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Fast Text Windows for AppleSOft....-cecccccesenes Michael Ching 
2118 Kula Street, Honolulu, HI 96817 


The program WINDER by Mike Seeds in the January 1985 NIBBLE was 
found to be very interesting. This was especially so because 
we, coincidentally, had been working on a similar routine for 
use in an upcoming strategy sports game, 


The main difference between our programs was that the routines 
used in WINDER are written completely in Applesoft, and thus 
suffer from the relatively slow speed of the Applesoft 
interpreters This is especially evident in the opening of the 
windows. Our routine. on the other hand, is written in 
assembly language and executes mere quickly. 


There are a couple of other major differences, Seeds’ routine 
saves the text, to be overwritten by the window, in a string 
array WSS. Our routine saves the text in the secondary text 
page (memory locations $800 through SBFF),. One advantage of 
doing this is that more than one window can be opened at the 
same time (although the windows may not overlap), A 
disadvantage is that the secondary text page occupies the same 
space that an Applesoft program normally would start at, This 
makes it necessary to relocate the Applesoft program above the 
secondary text page, 


Another difference is that WINDER specifies the window 
dimensions with the width and height of the window, along with 
the top and left coordinates. We chose to specify directly the 
top, bottom, left, and right boundaries. 


The assembly language routine is called by the familiar & 
followed by the appropriate parameters, The format is & 
WI,WB,WL,WR,TP where WT is the top coordinate of the window, WB 
is the bottom coordinate, WL is the left coordinate, WR is the 
right coordinate, and TP is the text page number. If TP is set 
to 1, the text to be replaced by the window is saved to the 
secondary text page and the window is formed. If TP is set to 
2, the text is restored to the primary text page from the 
secondary text page. At present, there is no error checking of 
the parameter values, and care must be taken to ensure that WB 
is set greater than WT, and WR greater than WL. 


The program is assembled to load into the tail end of the input 
buffer and the free space in page 3 ($2F5-3C9), The portion 
inside page 2 is only used to set up the ampersand hook, so it 
is not a problem if this code gets wiped out by long input 
lines after loading. This setup is done in lines 1250-1290. 


Lines 1320-1470 perform the task of getting the parameter 
values from Applesoft and placing them into temporary storage. 
The routines GETBYT and COMBYTE are used, and will evaluate 
expressions used in the calling Applesoft program. The width 
of the window is also calculated here, The text page value is 
decremented by one for ease of future manipulation, Line 1340 
initializes the beginning of a loop which will copy the 
Characters in the designated text page to the opposite text 


page, 
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Lines 1500-1510 call the monitor routine BASCALC. BASCALC 
calculates the starting (leftmost) memory address of the 
screenline, and stores it in the pointers BASL and BASH. 


Lines 1520-1640 set up two pointers, one in the real screen and 
one in the alternate screen area. The pointers point to the 
beginning of the current line starting at the left edge of the 
caller's window. Al points at the source, and A2 at the 
destination, for a move loop which will copy the characters 
within the window on the current line. 


The destination address is the source address offset by $400 
(up or down depending on the source text page). The 
calculation is done by exclusive ORing the source address with 
#$OC (or 00001100 in binary), For example, if BASH was $07, 
exclusive ORing will yield $0B. If it was $0B, exclusive ORing 
will yield $07. 


Lines 1660-1700 comprise the move loop. 


Lines 1720-1850 check to see if the frame of the window needs 
to be drawn. If the text page is being restored (window being 
Closed), then the frame routine is skipped. If the window is 
being cleared, the frame is drawn. 


First I store an inverse blank at each end of the line, which 
is sufficient for all except the top and bottom lines. Then I 
check: if it is the top or bottom line, I fill in the rest of 
the line with inverse blanks, 


Lines 1870-1900 check whether the entire window has been 
processed. If not, the program loops back to process the next 
line, 


Lines 1920-2050 check to see whether the window boundaries need 
to be set. If the window is being opened (TPAGE = 0), then 
they are set, and HOME clears out the window. Note that the 
window parameters are set so that the frame is outside it. 


aac QoAVE S WINDOWS 
1020 # MOVE WINDOW 
1030 ® by Mike Ching, Kula Software 
yet 7 2118 Kula Street. Honolulu, HI 96817 
20—- 1020 WNDLFT EQ $20 
21- Toke WNDWDTH .EQ $21 
22= 1080 WNDTOP EQ $22 
23- 1090 WNDBIM EQ $2 
20— 1100 BASL EQ $2 
29= 1110 BASH EQ 2 
18— 1120 Al EQ $18, 19 MEMORY SOURCE START 
1A- via A2 -EQ $1A, 1B MEMORY SOURCE END 
03F5~- 3s AMPERV .EQ $3F5 
E6F8- 1170 GETBYT EQ $E6F8 
E74C- 1180 COMBYTE .EQ aig C 
FBCi- 1190 BASCALC .EQ $FBC1 
FC58- 1200 HOME ~EQ $FC58 
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1290: Meee cnet ee eee eee aoe we 
1220 .OR $2F5 
1230 TF B.WINDOWS 
1280, Beeeeesee ceo ee ot eeeeeaeee 
O2F5- 49 00 1250 SRTUP LDA #MOVE.WINDOW SET UP & VECTOR 
O2F7- 8D F6 03 1260 STA AMPERV+1 
O2FA- 49 03 | 1270 LDA /MOVE.WINDOW 
O2FC- 8D F7 03 1280 STA AMPERV+2 
O2FF- 60 1290 RTS 
1340 MOVE . WINDOW 
0300- 20 F8 E6 1320 JSR GETBYT GBT VALUES FROM APPLESOFT 
030 - bE ih a3 1310 STX LINE 
O30ce BE AG 05 1320 Str BOTTOM 
ge Lg BE Te 
euig Ge as 6h (eo Se Stat 
031B- 38 1410 SEC WIDTH = RIGHT-LEFT 
O31b- ED AT 03 ret ae LEFT 
0320- 8D A3 0 ako STA WIDTH 
oe - 20 NC EB 1450 JSR COMBYTE GET DIRECTION (1 OR 2) 
0327- SE A5 03 1470 . STX TPAGE 
1490 MOVE-LINE 
032A- AD AN 03 1500 LDA LINE BASL,H = BASCALC(LINE) 
032D- 20 C1 FB 1510 JSR BASCALC 
0330- 18 1520 CLC 
pasa AB Gt 03 j2h0 tT TPR aE 
0330- FO 02 1550 BEQ .1 .» SOURCE IS REAL SCREEN 
0338- 49 0C ~—-: 1560 EOR #$0C *: SSOURCE IS SAVED SCREEN 
033A- 85 19 1570 «1 STA Al+1 SOURCE HI BYTE 
033C- 49 0G ~—_: 1580 ROR #$0C FLIP TEXT PAGE 
033E- es 1B —- 1590 STA AD+1 DESTINATION HI BYTE 
0340- 1 1600 CLC MEMSTART = BASL,H + LEFT 
SA Ah a 
0346- 85 18 ~ 1630 STA Al SOURCE LO BYTE 
0348- 85 1A «1640 STA A2 DESTINATION LO BYTE 
1650 ®---MOVE THE LINE SEGMENT-------- 
O34A- AC AZ 03 1660 LDY WIDTH 
O34D- Bi 1 1670 62 LDA (A1),¥ 
O34F- 91 1A  —- 1680 STA (A2).¥ 
Ose 2- 45 F9 1030 BEL .2 
10 #.--IF CLEARING, DRAW FRAME------ 
0354- AC AS 03 1720 LDY TPAGE 
0357- DO 1B 1730 BNE .4 ...NOT CLEAR- DO NOT DRAW FRAME 
0 55 AQ 2 1740 LDA #$20 INVERSE BLANK 
ee O ete | Hii: trae 
0360- 91 1 1770 STA (A1).Y¥ RIGHT SIDE 
0362- AE AS 03 1780 LDX LINE 
0365- EC 9F 0 1790 CPX TOP 
Oeae BS ae 03 1810 cpr perro OP CLINE 
o36D- DO 0 1820 h .»NEITHER TOP NOR BOTTOM 
O36F- 91 1 1830 3 STA (a1).Y 
0371- 88 1840 DEY 
0372- DO FB 1850 one 
0374~ EE A4 03 1870 4 INC LINE UNTIL LINE > BOTTOM 
Oar Te ee Ae O8 tBso CHP LINES 
O3tb- BO AB > 1900 BCS MOVE.LINE ANOTHER LINE TO MOVE 
1910 #---IF CLEARING, SET WINDOW------ 
O37F- AD A5 03 1920 LDA TPAGE 
0382- DO 1A | 1930 BNE .5 
G387- ge AT 03 1380 1 ae 
ett i 86 20 1960 STX WNDLFT 
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MORE RAMWORKS™ MEMORY! 


Everything needed, including easy instructions on expanding 
your Ramworks Card with MORE MEMORY FOR YOUR 
APPLE //e! All chips are highest quality & guaranteed 
three years. Can be used with other memory cards and 
printer buffers also - CALL FOR DETAILS. List Our 
Price Price 
64k Ramworks expander kit 70. 47. 
128k Ramworks expander kit 140. 92. 
256k Ramworks expander kit 250. 162. 
512k Ramworks expander kit 500. 314. 
1024k Ramworks expander kit 1099. 659. 


64k Ramworks Card (complete)* 179. 158. 
128k Ramworks Card (complete)* 249. 199. 
256k Ramworks Card (complete)* 399. 299. 
512k Ramworks Card (complete)* 649. 485. 

1024k Ramworks Card (complete)* 1199. 899. 


* Includes FREE AppleWorks Expander software! 


Appleworks Program 250. 210. 
Imagewriter (wide carr/acc kit) 749. 626. 


Terms: For fastest delivery send Cashier's or Certified check, or Money Order. 
C.0.D. and personal checks accepted (allow 14 days toclear). Add 3% for 
MasterCard/Visa (include # and expiration). Add $3 shipping. Texas residents 
add 6%% sales tax. 


Ramworks, AppleWorks/Imagewriter trademarks of Applied Engineering & Apple Computer 
respectively. Dealer inquiries welcome. 


COIT VALLEY COMPUTERS (214) 234-5047 
14055 Waterfall Way Dallas, Texas 75240 
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038A- AE A3 03 1970 LDX WIDTH 
0 BD- ch 13 0 DEX 
038E- 86 2 1990 STX WNDWDTH 
0390- AE 9F 03 2000 LDX TOP 
0393- E8 2010 INX 
039 - 86 2 2020 STX WNDTOP 
0306- AE AO 03 2030 LDX BOTTOM 
0399- 86 2040 STX WNDBT™M 
039B- 20 58 FC 2050 JSR HOME 
039E- 60 2060 5 RTS 
039F- 2080 TOP _—-«.BS 1 PROGRAM STORAGE 
03A0- 2090 BOTTOM .BS 1 
O3A1- 2100 LEFT .BS 1 
03A2- 2110 RIGHT .BS 1 
03A3- 2120 WIDTH .BS 1 
O3A4- 2130 LINE 1 
03A5- 140 TPAGE 1 
9150 Qc eeacseaceosaeeieseeecouesaenees 


The next listing shows the revised WINDER routine using the 
assembly language routines, Line 40 checks to see if the 
program has been relocated above the secondary text page. If 
not, the start of program pointers are changed and the program 
is re-RUN» This causes DOS to position the program above the 
secondary text page. Line 50 BRUNS the assembly language 
routine. 


The program is really quite different from that of Mike Seeds, 
as you can see if you compare them. Clearing and restoring 

windows is now very efficient, due to the &-routine. I moved 
the delay and closing logic into a common subroutine. I also 
added a randomly sized and positioned window in lines 400-410. 


10 REM WINDOW DEMO PROGRAM, BASED ON PROGRAM 
en peal BY MIKE SEEDS NIBBLE. JAN 1985 


EM 
OP = 12: IF PEEK (104 ) < P THEN POKE 104,P: POKE P ® 256.0: PRINT CHR$ 


(4) "RUN WINDOW DEMO* 
50 PRINT CHRS (4)"BRUN B.WINDOWS® 
60 REM ewww nnn enn wn e eee e 
100 TEXT : HOME 
110 FOR I = 1024 TO 2047 STEP 128: FOR J = 0 TO 119: POKE I + J, RND (1) 
+ : ; | 
" WINDOW DEMONSTRATION";: CALL - 868: PRINT : CALL - 


130 Sear 22: CALL - 958: PRINT : PRINT * PRESS ANY KEY TO HALT®; 


150 T = 10:B = 14:L = 12:R = 21: & T,B REM OPEN WINDOW 
if RINT " TINY WINDOW": GOSUB rOobe a DELAY AND CLOSE WINDOW 


§8 rit 2B = Tile erp = 9s et 1 
210 VTAB T + 3: HTAB 4: PRINT ayorice THE TEXT IS": HTAB 4: PRINT "RESTO 
RED CORRECTLY. " 


220 GOSUB 1000 
O30 (REM sess e eee elecetecs 
260 T = 10:B = 19: & T.B,L,R.1 

0 FOR J = 110 25: PRINT ® ":J.Jd ® J: NEXT J 
280 PRINT : PRINT *® SCROLLING I$ AUTOMATIC® 
290 GOSUB 1000 


0 REM mann nce eccccncnonensnwes 

800 W's RN (1) ® 20 + SsH =| RND (1) # 10 + 5:7 = RND (1) ® (24 - H):B 
+ H:L = AND (1) # (40 - L + 

410 SofePasgtet y1: PRINT *ABCDEFGHIJKLMNOPQRSTUVWXY2" : GOSUB 1000 


1380 FOE De EP MRSC ME oy 
1020 cE Ball a = i 12 N THEN RETURN 


1030 POP : ss O: TEXT :; HOME ;: END 
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An 8086/8088 Cross AsSemblera...cesccscceeccceeees DON Rindsberg 


As one of S-C's avid fans, I have developed an 8086/8088 Cross 
Assembler for your Apple which will enable you to generate code 
to run on the IBM FC's and their clones as well as many other 
16-bit machines. All the 8086/8088 instructions are covered as 
well as the multiplicity of addressing modes. The mnemonics 
are based on Microsoft's assembler, This assembler is based on 
S-C Assembler II Version 4.0 (the one before Macro Assembler), 
so it doesn't include the newer features like macros or the 
EDIT command. Documentation covering the differences from the 
6502 version is included. 


With Bob's permission, XSM 8086/8088 is available to owners of 
the S-C 6502 assembler (Version 4.0 or later) for $80.00 post- 
paid. Included on the disk are sample source programs s0 you 
can become familiar with the syntax. Send personal check or 
money order (no credit cards or purchase orders) to: 


The Bit Stop 

5958 S. Shenandoah Rd. 
Mobile, AL 36608 
Attn: Don Rindsberg 
(205) 342-1653 


HoockIBLyY COANEH 


assens/y /enguage for the beg/nner 
PEPPPPPEPLESPPEE LED ESOL P LE PCOELOP PISO CEOS PEEL ERE LS GOSES EBLE, 


WINDOWS! 
for the APPLE Il computer 


Windows is: ole cn en ee, Le 
-Macintosh-like windows for those who are serious about learning to 
for the Apple Il! progres. 
L Assambly for the serious 
-Easy to use from Basic! four lessons each month on disk, along 
-Ten new commands! aan ore eee re eo 
= special ef ects creator! 2 Graphics and Animation ih gaaaaa 
-A screen splitter! gh i apond disks full of information 
-Compatible with all Applell nak pale rap, vith = 
rade with es = ie pdaecardor 
-Compatible with Pro clapbad beg ame 
and DOS 33 7 ale 


-Only $19.95! 


Display any message, menu, 
etc. right over the existing 
text without destroying the 
original display. Windows 
are completely independent. 
Send your check to: 


oa OPO OSES 8 @ @ OOS CF OSS OSS8SE8 0082288208208 088 aod 
Jan Eugenides, 11601 N.W. 1@th St. ! 
!Pembroke Pines, FL 33026 ] 
4 22 DP OD DP OE SES OOS BS S2 SHS 2S SSS FSS SSE BSG8® on} 
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1 Yes, I want to learn! Send me: 

| __Tha beginners’ series (one month) $15 
| _The beginners’ series (one year) $158 
1 __ The Graphics series (one disk) = 15 
| __The Graphics series (one year) $58 
1 A free assembl e fact poster 
! is included wi order !! 
! 
! 
i 
} 


Foca CoA 
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A Powerful 65816 Board on the Horizon......Bob Sander-Cederlof 


Some of you may have heard of Micro Magic, a company in Mary- 
land that is planning to produce a plug-in card for your Apple 
with fast RAM and a fast 65816. Well, if not, now you have. 


I spoke yesterday with Will Troxell, and got an overview of 
their plans. He and Frank Krol are working together on the 
project. Their goal is to produce the most powerful and 
flexible card they can and yet still bring it in for a low 
price. The card will basically be similar to the Accelerator 
//e, in that it consists of a fast microprocessor, fast RAM, 
and the logic to take control away from the 6502 or 65C02 on 
your Apple motherboard. 


But instead of a 65C02 running at 3.58 MHz, you will get a 
65816 running at 6 MHz. Instead of one row of RAM chips, you 
get two. Troxell's board will probably come with 64K or 128K 
of 6MHz dynamic RAM, but later this year they have been 
promised that 256K RAMs fast enough for 6 MHz operation will be 
in production; then you will be able to expand your board to 
256K or 512K bytes of RAM. 


There is a firmware socket on the board which can accept a 
27128 (16K bytes of firmware, the same as you find in a //c). 
They do not plan to include any firmware at the beginning, but 
it certainly can be filled up with your own goodies. 


There are two external connectors on the board. One of these 
allows you to add another 512K RAM. Remember, this is directly 
addressable RAM, not bank-switched. The 65816 can directly 
address up to 16 megabytes, with its 24-bit address bus. 


It is also exciting to remember that a plain ol 6502 running at 
1 MHz (what you have now) is roughly equivalent in speed to 
most of the 8088 and Z-80 computers on the market. A 6 MHz 
6502 could beat a 20MHz 2-80 (were they to make one so fast). 

A 6 MHz 65816 will beat out 68000's, 80286's, and so on. Why 
is this true? Because all those other chips use micro- 
programmed instruction sets, taking many clock cycles for each 
instruction. The 6502 and its progeny are fully implemented in 
hardware gates, so only a handful of clock cycles are needed. 


Furthermore, a 65816 instruction will take from one to four 
bytes of memory, while a 68000 instruction will take 2, 4, 6, 
8, or 10 bytes. Now I am not trying to deny the power of some 
of those 68000 instructions. One of them may take many steps 
in 65816 code. Especially if you need to deal with 32-bit 
operands. But it is my experience that those super 
instructions are relatively infrequent in practical programs. 
Most programs spend most of their time just moving bytes from 
here to there and back again. 


Now if we could only get one! For about fifteen months we have 
been hearing “in two to four weeks". We could despair, were it 
not for our historical perspective. The same thing happened 
with the 65C02, and now we really do have them in abundance. 

By this time next year, you may be hearing solid confirmation 
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of the rumor (heard this week) that Apple and GTE are 


discussing large orders of 6581l6s. 


But I digress. 


Back to Troxell and Krol. 


There new board will 


be called the MAX-816, and a new operating system they are 
designing for it will be MAX-OS. 
will optimize memory re-mapping for both DOS and ProDoS, 

automatically, so that maximum possible use is made of the fast 
THe fewer times the card has to slow down to 


use motherboard RAM, the faster your programs fly. 


RAM on the card. 


A special circuit on the card 


MAX-OS will not be necessary for you to get a bang out of 
MAX-816, because it will work like the Accelerator //e and make 
most existing programs six times faster (exclusive of I/0). 

But when it is ready, it will open up new vistas, with RAM 
stretching out in every direction as far as the eye can see. 

In a design reminiscent of one from a certain large phone 
company, the kernel is written in assembly language, with a 


C-shell wrapped 


around it. 


Personally, I am no great fan of complex operating systems. 


The simpler and smaller the better, in my book. 


I still like 


DOS 3.3, especially with enhancements I regularly patch in. 
Nevertheless it does take more management when you have the 
Magnitude and variety of resources that will be in the Apple of 


the future. 


Maybe MAX-OS will be the winner. 


If Will and Frank are whetting your appetite, you can write to 


them at Micro Magic, Box 281, Millersville, MD 21108. 


Or you 


Might be able to reach them at (301) 987-6083. 


Now you can monitor and control the world (or at least your part of it) with a little help from 


APPLIED ENGINEERING 


12 BIT, 16 CHANNEL, 
PROGRAMMABLE GAIN A/D 
@ All new 1984 design incorporates the 
latest in state-of-art 1.C. technologies. 
@ Complete 12 bit A/D converter, withan 
accuracy of 0.02%! 


@ 16 single ended channels (single ended 
means that your signals are measured 
against the Apple's GND.) or 8 
differential channels. Most all the 
signals you will measure are single 
ended. 

@ 9 software programmable full scale 
tanges, any of the 16 channels can have 
any range at any time. Under program 
control, you can select any of the 
following ranges: +10 volts, £5V, 
£2.5V, +1.0V, +SOOMV, +250MV, 
+1O0MV, t5OMV, or t25MV. 

@ Very fast conversion (25 micro seconds). 

@ Analog input resistance greater than 
1,000,000 ohms. 

@ Laser-trimmed scaling resistors. 

@ Low power consumption through the 
use of CMOS devices. 

@ The user connector has +12 and -12 
volts on it so you can power your 
sensors. 

@ Only elementary programming is 
required to use the A/D. 

@ The entire system is on one standard 
size plug in card that fits neatly inside 
the Apple. 

@ System includes sample programs on 


Suk PRICE $319 
A lew ape ations may include the moni 
toring of @ flow @ temperature @ humidi- 
ty @ wind speed @ wind direction @ light 
intensity @ pressure @ RPM @ soil mouis- 
ture and many more. 


A/D & D/A 


A/D & D/A Features: 

@ Singte PC card 

@ 8 channels A/D 

@ B channels D/A 

@ Superfast conversion time 


@ Very easy programming 
@ Many analog ranges 
@ Manual contains sample applications 


A/D SPECIFICATIONS 

@ 0.3% accuracy 

@ On-board memory 

@ Fast conversion (078 MS per channel) 

@ A/D process totally transparent to 
Apple (looks like memory) 

@ User programmable input ranges are 
0 to 10 volts,0 to 5S, - Sto +5. -2.5 
to +2.5,-$to0, -10t00. 


The A/O process takes place on a continuous, 


channel sequencing basis. Data is automatic- 
ally transferred to its proper location in the 
on-board RAM. No A/D converter could be 
easier to use. 
D/A SPECIFICATIONS 

@ 0.3% accuracy 
@ On-board memory 
@ On-board output buffer amps can 

drive 5 MA 
@ O/A process is totally transparent to 

the Apple (just poke the data) 
@ Fast conversion (.003 MS per channel) 
@ User programmable output ranges are 

0 tu 5 volts and 0 to 10 volts 
The D/A section contains & digital to analog 
converters, with output buffer amplifiers and 
all interface logic on a single card. On-card 
latches are provided for each of the eight 
D/A converters. No O/A converter could be 
easier to use. The on-board amplifiers are 
laser-trinsmed during manufacture, thereby 
eliminating any requirement for off-set 


nulling PRICE $199 


Me 


SIGNAL CONDITIONER 


Our 8 channel signal conditioner is destgned for use with both our A/D converters. This 
board incorporates 6 F.E.T. op-amps, which allow almost any gain or offset. For example, 
an input signal that varies from 2.00 to 2.15 volts or a signal that varies from 0 to 50 
mV can easily be converted to 0-10V output for the A/D. 


The signal conditioners outputs are on a high quality 16 pin gold I.C. socket that 
matches the one on the A/D’s so a simple ribbon cable connects the two. The signal 
conditioner can be powered by your Apple or from an external supply. 


FEATURES 
@ 4.5" square for standasd card cage and 4 mounting holes for standard mounting, The 


Ary mee does not plug into the Apple, it can be located up to % mile away from 
@ 22 pin .156 spacing edge card input connector (extra connectors are easily available ie. 
Radio Shach). 
@ Large bread board area. 
@ Full detailed schematic included. 
PRICE $79 


1/O 32 


@ Your inputs can be anything from 
high speed logic to simple switches 


@ Provides 4, 8-Bt programmable 1/O @ Programming is made very easy by 
Posts powerful on-board firmware 
@ The I/O 32 is your best choice for any 


@ Any of the 4 ports can be pro- > YO 
control application 


grammed as an input or an output 
port 


@ All I/O lines are TTL (0-5 volt) 
compatible 


The 1/O manual includes many programs 
for inputs and outputs. 


Some applications include: 
Burglar alarm, direction sensing, use with relays to tum on lights, sound buzzers, start 
motors, control tape recorders and printess, use with digital joystick 

PRICE $89 


Please see our other full page ad in this magazine for information on Applied Engineering's Timemaster Clock Card and other products for the Apple. 
Our boards are far superior to most of the consumer electronics made today. All I.C.’s are in high quality sockets with mitspec. components used throughout P.C. boards are glass-epoxy 
with gold contacts. Made in America to be the best in the world All products compatible with Apple II and //e. 


Applied Engineering's products are tully tested with complete documentation and available for immediate delivery. All products are guaranteed with a no hassle three year warranty. 


Texas Residents Add 5% Sales Tax 
Add $10.00 If Outside U.S.A 


Send Check or Money Order to: 
APPLIED ENGINEERING 
P.O. Boa 798 
Carrollton, TX 75006 


Call (214) 492-2027 
7 am. to 11 p.m. 7 days a week 
MasterCard, Visa & C.0.D. Weicome 
No extra charge for credit cards 
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USR Command to List Major Labels Only......Bob Sander-Cederlof 


Sometimes when I am working with a large source file in the S-C 
Macro Assembler it would be nice to be able to list only those 
lines that define major labels. Seeing only them would give an 
overview of an entire file, and enable me to quickly find the 
section I want to work on. 


A major label is one that starts with a letter. Local labels 
Start with a period, macro private labels start with a colon. 
Lines might also start with an asterisk or semicolon, if they 
are comments, or with blank. 


You can add commands to the Macro Assembler in several ways. 
One easy built in one is the USR command. A vector at $pD007 
(or $1007 with the low memory version) can point to the code to 
process a command of your own making. Lines 1080-1140 in the 
following listing set up the vector for my special USR command. 
Since it is in the high RAM area (sometimes called “language 
card"), I reference $C083 twice to write enable the RAM. 


Once the USR vector is loaded, typing a command “USR* will 
execute my code. When this happens, the entire command I typed 
will be in a buffer starting at $200. Some routines exist 
inside S-C Macro which can help in parsing the command further 
and in implementing its functions, and I will use them in this 
example. If you have the source code to one of the S-C Macro 
versions, it is not too difficult to find these routines. And 
if you don't have it, you can always disassemble and analyze. a 
true form of adventure. The addresses shown in lines 1040-1060 
correspond to version 2.0 of the S-C Macro Assembler, 


Line 1165 calls on a subroutine I call PARSE.LINE.RANGE (PLR). 
PLR starts by setting up SRCP to point to the beginning of the 
source program, and ENDP to the end of same. Then it looks at 
the command line for various forms of line numbers. You might 
have none at all, in which case PLR is finished. You might 
have one number alone, or a period. (A period is shorthand for 
the last remembered line number.) That might be preceded by or 
followed by a comma. You might have two numbers separated by a 
comma. Here is a table showing what happens in each case: 


SRCP ENDP CARRY 


none pstart pend set 

# #start #end Clear 
#, #start pend Clear 
PZ pstart #end Clear 


#1,#%2 #lstart #2end clear 


where # means number or “."* 
pstart = address of start of source code 
pend = address of end of source code 
#start = address of starting line # 
#end = address of ending line # 


Line 1170 call a routine in the assembler to compare SRCP and 
ENDP to see if we are finished or not, The code is simply: 
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CECEEEEEEEEEEEEEEEEEEESEEEEEEEEEEEEEEEES 


FONT DOWNLOADER & EDITOR ($39.00) 

Turn your printer into a custom typesetter. Downloaded characters remain active while printer is powered. 
Use with any Word Processor program capable of sending ESC and control codes to printer. Switch back and 
forth easily between standard and custom fonts. All special printer functions (like expanded, compressed etc.) 
apply to custom fonts. Full HIRES screen editor lets you create your own characters and special graphics 
symbols. Compatible with many parallel printer |/F cards. User driver option provided. For Apple li, Ii+, //e. 
Specify printer: Apple Dot Metrix, C.ltoh 8510A (Prowriter), Epson FX 80/100, or OkiData 92/93. 


NEW ! !! The Font Downloader & Editor for the Apple tmagewriter Printer. For use with 
Apple li, \l+, //e (with SuperSerial card) and the new Apple //c (with builtin serial interface). 


NEW !!! FONT LIBRARY DISKETTE #1 ($19.00) contains lots of user-contributed fonts for all 
printers supported by the Font Downloader & Editor. Specify printer with order. 


DISASM 2.2e - AN INTELLIGENT DISASSEMBLER ($30.00) 

Investigate the inner workings of machine language programs. DISASM converts machine code into meaningful, 
symbolic source. Creates a standard text file compatible with S-C, LISA, ToolKit and other assemblers. Handles 
data tables, displaced object code & even lets you substitute your own meaningful labels. (100 commonly used 
Monitor and Pg Zero names included.) An address-based triple cross reference table is provided to screen or 
printer. DISASM is an invaluable machine language learning aid to both novice & expert alike. Don Lancaster 
says DISASN is “absolutely essential” in his new ASSEMBLY COOKBOOK. For entire Apple I! family including the 
new Apple //c (with all the new opcodes). SOURCE CODE available for an additional $30.00 


S-C Assembler (Ver 4.0 only) SUPPORT UTILITY PACKAGE ($30.00) 

* SC XREF - Generates a GLOBAL LABEL Cross Reference Table for complete documentation of source listings. 
* SC.GSR - Giobal Search & Replace eliminates teadious manual renaming of labels. Search all/part of source. 
* SC.TAB - Tabulates source files into neat, readable form. SOURCE CODE available for an additional $30.00 


The ‘PERFORMER’ CARD ($39.00) 

Plugs into any slot to convert a ‘dumb’ centronics-type printer I/F card into a ‘smart’ one. Command menu 
eliminates need to remember complicated ESC codes. Features include perforation skip, auto page numbering 
with date & title. Includes large HIRES graphics & text screen dumps. Specify printer: MX-80 with 
Graftrax-60, MX-100, MX-80/100 with Graftraxplus, NEC 6092A, C.Itoh 6510 (Prowriter), OkiData 82A/83A 
with Okigraph & OkiDate 92/93. SOURCE CODE: $30.00 


FIRMWARE FOR APPLE-CAT: The ‘MIRROR’ ROM ($25.00) 

Communications ROM plugs directly into Novation's Apple-Cat Modem card. Basic modes: Dumb Terminal, 
Remote Console & Programmable Modem. Features include: selectable pulse or tone dialing, true dialtone 
detection, audible ring detect, ring-beck. printer buffer, 80 col card & shift key mod support. Uses superset of 
Apple's Comm card and Micromodem I! commands. SOURCE CODE: $50.00 


RAM/ROM DEVELOPMENT BOARD ($30.00) 
Plugs into any Apple slot. Holds one user-supplied 2Kx6 memory chip (6116 type RAM for program development 
or 2716 EPROM to keep your favorite routines on-line). Maps into $CnO0O-CnFF and $C800-CFFF. 


NEW !!! C-PRINT For The APPLE //c ($99.00) 

Connect standard parallel printers to an Apple //c. C-PRINT is a hardware accessary that plugs into the 
standard Apple //c printer serial port. The other end plugs into any printer having a standard 36 pin 
centronics-type parallel connector. Just plug in and print! High speed data transfer at 9600 Baud. No need to 
reconfigure serial port or load software drivers for text printing. 


Avoid a $3.00 postage/handling charge by enclosing full payment with order. (Mastercard & VISA excluded) 
RAK-WARE 41 Ralph Road W. Orange NJ 07052 (201) 325-1885 


CECCEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 
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LDA SRCP 
CMP ENDP 
LDA SRCP+1 
SBC ENDP+l 


Lines 1200-1210 pick up the first character after the line 
number, The source line format in memory is one byte for a 
byte count, two bytes for the line number, the text of the 
line, and a final terminating 00 byte. The blank which follows 
just after the line number in listings is not actually stored. 


Characters in a source line are stored in “low” ASCII, values 
between $01 and $7F. Values from $81 through SBF indicate 1 to 
63 blanks. The value $CO indicates repetitions of some other 
character. The byte following a $CO is the repetition count, 
and the byte after that is the character to be repeated. Lines 
1220-1240 check for blanks and repeat tokens. Lines 1340-1350 
pick up the repeated character if we found a repeat token, 


Lines 1360-1390 check if the first character is a letter. If 
not, this line will not be listed. Lines 1250-1320 are 
executed to skip over the current line without listing it. 
Since the first byte of the line has a byte count, it is added 
to SRCP to move up the next line, 


At line 1400 I call LIST CURRENT LINE to ,.. you guessed it. 
This subroutine also advances SRCP, so after it is finished I 
jump back to the top to check pointers and get the next line, 


After assembling the program, I type MGO INIT to hook it in. 
Then “USR 1070," would list just lines 1080 and 1160. 


010 
DD- see SRCP -EQ $DD,DE 
DEAF- 10h PARSE . LINE . RANGE ~EQ $DEAF OR 1EAF 
DF11- 1050 CMP.SRCP.ENDP ~-EQ $DF11 OR 1F11 
DT37T- 1000 LIST.CURRENT. LINE ~EQ $D737 OR 1737 
ieee #.-—-LINK COMMAN D----------------- 
0800- AD 83 CO 1080 INIT LDA $C083 ENABLE LANGUAGE CARD 
0803=- AD 83 CO 1090 LDA $C083 
O800=- AQ 1 1100 LDA #USR.LIST SET UP USR VECTOR 
0808- 8D 07 DO 1110 STA $D007 
O80B- A9 1120 LDA /USR.LIST 
O80D-—- 6p 08 DO eS STA $D008 
0810=- 60 1140 
1128 #---USR COMES HERE--------------- 
1160 USR.LIST 
oR t- 20 AF DE 1165 JSR PARSE.LINE. RANGE 
0814— 20 11 DF ey o1 JSR CMP.SRCP.ENDP 
oF tg: 0 01 1180 BCC .2 
0819- 60 1190 RTS 
O81A=- AO 03 1200 .2 LDY f2 POINT TO FIRST CHAR 
A B1 DD 1210 LDA (SRCP),Y 
OS1E= 10 17 1220 BPL .5 NOT TOKEN 
0820- C9 CO ‘ot, CMP #3C0 
0822- BO OF 12 BCS . REPEAT TOKEN 
O824- AO 00 ‘eee 3 LDY #0 SKIP TO NEXT LINE 
0826- Bi DD 1260 LDA (SRCP),Y LINE LENGTH 
0828- 18 A CLC 
0829- 65 DD 1280 ADC SRCP 
2Be DD 1290 STA SRCP 
O82D- 90 E5 1300 BCC .1 
082F- E6 DE 1310 INC SRCP+1 
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0833- AO 05 1340 .4 LDY f POINT AT RPTD CHAR 
0835- Bi DD 1350 LDA (SRCP),Y 

08 fe C2 4 1360 .5 CMP #'A! 

oe - 90 E9 1 fo BCC 3 NOT LETTER 

033B- C9 5B 1380 CMP #°Z'+1 

083D- BO E5 1330 BCS .3 NOT LETTER 

ae - 20 3{ Dy 1400 JSR LIST.CURRENT . LINE 

O842- AC a . JMP .1 


Review of the FCP Hard Disk......ccecceseeee BOD Sander-Cederlof 


First Class Peripherals has been advertising for some months 
now their 10 megabyte hard disk system (The Sider) for the 
Apple, At only $695, including drive, controller, cable, and 
software, it sounds too good to be true. We called them and 
asked for a chance to write a review, and they loaned us one 
for a month, 


I first tried hooking it up to an Apple II Plus, the same one 
we have used with hard disks in the past. However, after 5 or 
6 wasted hours, it still would not function. We could not even 
get the disk to completely initialize. I finally called the 
800 number for customer service, and found out that there have 
been problems hooking the Sider to some II+'s. They suggested 
trying it on a //e before giving up. Sure enough. it worked 
perfectly on our //e. The Sider is sold subject to a 15-day 
trial period, so there is plenty of time to find out if it will 
work with your II+. 


I am very pleased. The Sider works well, looks good, and is 
not too noisy. We have heard of at least one customer who did 
complain of the noise level, but I have never listened to a 
quieter one, Because of the venting design there is no 
internal fan, so the only noise is the spinning disk. Anyway, 
my office already has two fans going on Apples and another in a 
Minolta copier. The Sider nicely masks them all. 


The size and shape are nice, too. It is somewhat smaller than 
I expected: less than 4x8xl6 inches. At first I set it along 
side of my Apple (after all it is called the Sider), but now it 
is along the back edge of my work table. This way it takes 
practically no space at all, yet I can still easily reach the 
on/off switch. 


The installation software that comes with the Sider initializes 
the 10 megabytes into four separate partitions. One is for 
DOS, one for ProDOS, one for CP/M, and one for Pascal. You can 
vary the partition size for each one, although a certain 
minimum amount must be allocated; you cannot squeeze one all 
the way out. The DOS partition allows a combination of floppy 
size volumes and large volumes. The large volumes give you 
three times the amount of a regular Apple floppy. I set mine 
up with 32 small volumes and one large volume, 


The ProDOS partition divides the allocated space into two equal 
size volumes, designated /HARD1/ and /HARD2/. Since I shrank 
CP/M and Pascal to the minimum, the ProDOS volumes are about 
2.5 megabytes each, 
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If you want to change the partitions, you have to completely 
re-initialize. That means all your files will disappear. Of 
course you can restore them from your backup floppy copies. 


The only modification to DOS 3.3 that the Sider makes is to put 
a call to their firmware at S$BD00. I decided to apply my own 
set of patches, which among other things speed up LOAD, BLOAD, 
RUN, and BRUN, They were not only compatible, they even 
speeded up the hard disk! Here is a table comparing the Sider 
with floppies, both with and without my patches: 


BLOAD ----floppies----- ----The Sider---- 
# sectors standard patched standard patched 

22 Tel 3.8 320 1.3 

69 18.7 5.6 6.7 2.4 

131 32.6 8.6 12.3 3.8 


I also timed the assembly of a large program, whose source was 
on two disks (the S-C Macro Assembler itself, in fact). With 
my speed up patches the floppy assembly took 4 minutes 50 
seconds; the Sider with standard DOS took 3 minutes 50 seconds; 
the Sider with my patches took only 2 minutes 32 seconds. 


All these times are under DOS 3.3 of course, ProDOS is about 
the same as my patched version of DOS in speed, but has other 
advantages like larger volumes and files. 


The main competition for the Sider comes from the two most 
popular companies, Apple and Corvus. Apple‘s ProFILE hard disk 
is sleek and nice, and only costs three times what the Sider 
does. Since you are paying more, you also get less: Apple 
only supports ProDOS. The ProFILE doesn't work with CP/M, 
Pascal, or DOS 3.3. (Unless there is a new ProDOS compatible 
Pascal.) Corvus costs even more than ProFILE, last time I 
checked. On the other hand, they have an excellent reputation. 


Its always hard to trust some new little company, even when 
they have a great product and pricee Just who is First Class 
Peripherals, anyway? Well, they are a subsidiary of Xebec, one 
of the bigger makers of hard disks. Xebec has been around a 
long time (over ten years) and has a first class reputation. I 
think we can depend on them, The Sider comes with a one-year 
limited warranty, which I think means that if it breaks you 
send it in and they will fix it or replace it. (Note: a whole 
year, not just 90 days!) After the warranty has expired there 
is a flat $150 charge for repairs. 


The only way to buy a Sider is directly from First Class Peri- 
pherals. You can call them at 1-800-538-1307, or write to 2158 
Avenue C, Bethlehem, PA 18001, If you are in a user group of 
Significant size, I understand someone at FCP might want to 
visit with a demo unit. You might give them a call. 
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